home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1995 April / Internet Tools.iso / infoserv / www / cern / doc / www-talk.archive.Z / www-talk.archive / text0263.txt < prev    next >
Encoding:
Text File  |  1992-11-30  |  2.0 KB  |  53 lines
  1. Almost a month ago, Tim wrote:
  2. > I know I heard of someone with a filter for unix man page to HTML,
  3. > but I can't find it.  Does anyone on this list write one?
  4.  
  5. OK, I finally have a reasonably nice-looking man converter.  It does
  6. the following things:
  7.  
  8. * puts section headings in <H2> </H2>'s.
  9. * formats paragraphs with <P>.
  10. * does some special characters.
  11. * hypertext links for references to other manual pages.
  12. * some <HP?> highlighting.
  13.  
  14. Current problems:
  15.  
  16. * it's not lightning fast.
  17. * doesn't handle tbl correctly yet.
  18. * it would be nice to put some things in a <DL> type list.
  19. * many of the special characters missing.
  20. * it does some strange spacing sometimes.
  21.  
  22. The filter is in a number of parts.  The first part is written in perl,
  23. and parses the man page names and gets a list of filenames, which it
  24. pipes to groff.  I have built a special groff filter in perl for the
  25. second part.  This filter takes the groff device-independent intermediate
  26. output, and converts it to HTML.
  27.  
  28. The code's not too bad, but could do with a bit of cleaning-up,
  29. particularly the tbl handling.  You can play with the filter by connecting
  30. to:
  31.  
  32.   http://www.vifp.monash.edu.au:5000/MANPAGE
  33.  
  34. where MANPAGE can just be a name, like 'cat', or it can be a name and
  35. section, like 'cos(3m)'.
  36.  
  37. Please tell me if you notice anything strange, and I will attempt to
  38. fix it.  I'll give the code to people if they really want it, but as I said
  39. before, I hope to clean it up a little before I release it more
  40. generally.  To run the code, you need groff and perl and you need to be
  41. able to install new drivers for groff (I think there's an option for
  42. groff to look in a different directory for drivers).
  43.  
  44. This is part of our local help/documentation system, which will
  45. eventually be complete, changing documentation for our computer
  46. systems.  I essentially wanted to be able to direct people to the man
  47. pages when necessary, and I thought it pointless to have man pages if
  48. you couldn't just click on the "See Also"'s  :-)
  49.  
  50. Have fun, and let me know what you think.
  51.  
  52. rik.
  53.